home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / drawmo.z / drawmo
Encoding:
Text File  |  1998-10-20  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddrrrraaaawwwwmmmmoooo((((3333GGGG))))                                                          ddddrrrraaaawwwwmmmmoooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddrrrraaaawwwwmmmmoooo - selects which GL framebuffer is drawable
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ddddrrrraaaawwwwmmmmoooo((((mmmmooooddddeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmooooddddeeee
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   expects the identifier of the framebuffer to which GL drawing
  17.             commands are to be directed:
  18.  
  19.             NNNNOOOORRRRMMMMDDDDRRRR, which sets operations for the normal color and z buffer
  20.             bitplanes.
  21.  
  22.             OOOOVVVVRRRRDDDDRRRRWWWW, which sets operations for the overlay bitplanes.
  23.  
  24.             UUUUNNNNDDDDRRRRDDDDRRRR, which sets operations for the underlay bitplanes.
  25.  
  26.             PPPPUUUUPPPPDDDDRRRRWWWW, which sets operations for the pop-up bitplanes.
  27.  
  28.             CCCCUUUURRRRSSSSDDDDRRRR, which sets operations for the cursor.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      The IRIS physical framebuffer is divided into 4 separate GL framebuffers:
  32.      pop-up, overlay, normal, and underlay.  ddddrrrraaaawwwwmmmmoooo specifies which of these
  33.      four buffers is currently being controlled and modified by GL drawing and
  34.      mode commands.  Because ddddrrrraaaawwwwmmmmoooo cannot be set to multiple framebuffers, GL
  35.      drawing commands affect only one of the four GL framebuffers at a time.
  36.  
  37.      The way that GL modes interact with ddddrrrraaaawwwwmmmmoooo is both complex and
  38.      significant to the GL programmer.  For example, each framebuffer
  39.      maintains its own current color and its own color map, but linewidth is
  40.      shared among all framebuffers.  In general, modes that determine what is
  41.      to be drawn into the framebuffers are shared; modes that control
  42.      framebuffer resources are either multiply specified, or specified only
  43.      for the normal framebuffer.
  44.  
  45.      A separate version of each of the following modes is maintained by each
  46.      GL framebuffer.  These modes are modified and read back based on the
  47.      current draw mode:
  48.  
  49.           bbbbaaaacccckkkkbbbbuuuu
  50.           ccccmmmmooooddddeeee
  51.           ccccoooolllloooorrrr or RRRRGGGGBBBBccccoooollll
  52.           ddddoooouuuubbbblllleeee
  53.           ffffrrrroooonnnnttttbbbb
  54.           mmmmaaaappppccccoooollll (a separate color map per framebuffer)
  55.           rrrreeeeaaaaddddssssoooo
  56.           RRRRGGGGBBBBmmmmoooodddd
  57.           ssssiiiinnnngggglllleeee
  58.           wwwwrrrriiiitttteeeemmmm or RRRRGGGGBBBBwwwwrrrriiii
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddrrrraaaawwwwmmmmoooo((((3333GGGG))))                                                          ddddrrrraaaawwwwmmmmoooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      The following modes currently affect only the operation of the normal
  75.      framebuffer.  They must therefore be modified only while draw mode is
  76.      NNNNOOOORRRRMMMMAAAALLLL.  As features are added to the GL, these modes may become
  77.      available in other draw modes.  When this happens, a separate mode will
  78.      be maintained for each draw mode.
  79.  
  80.           aaaaccccssssiiiizzzzeeee
  81.           bbbblllliiiinnnnkkkk
  82.           ccccyyyycccclllleeeemmmm
  83.           mmmmuuuullllttttiiiimmmm
  84.           oooonnnneeeemmmmaaaapppp
  85.           sssseeeettttmmmmaaaapppp
  86.           sssstttteeeennnncccciiii
  87.           sssstttteeeennnnssssiiii
  88.           sssswwwwrrrriiiitttteeee
  89.           zzzzbbbbuuuuffffffffeeee
  90.           zzzzddddrrrraaaawwww
  91.           zzzzffffuuuunnnncccctttt
  92.           zzzzssssoooouuuurrrrcccc
  93.           zzzzwwwwrrrriiiitttteeee
  94.  
  95.      All other modes, including matrices, viewports, graphics and character
  96.      positions, lighting, and many primitive rendering options, are shared by
  97.      the four GL framebuffers.
  98.  
  99.      Draw mode CCCCUUUURRRRSSSSDDDDRRRR differs from the others.  True bitplanes for the cursor
  100.      do not exist; there is no current color or writemask in this drawing
  101.      mode.  However, the cursor does have its own color map, and when in this
  102.      mode, mmmmaaaappppccccoooollll and ggggeeeettttmmmmccccoooo access it.
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      c, color, cpack, gconfi, getcol, getmco, getwri, mapcol, overla, stenci,
  106.      underl, wmpack, writem
  107.  
  108. NNNNOOOOTTTTEEEESSSS
  109.      This routine is available only in immediate mode.
  110.  
  111.      Some GL modes that are shared by all draw modes are not implemented by
  112.      the popup, overlay, or underlay framebuffers.  For example, the Personal
  113.      Iris does not do Gouraud shading in these framebuffers.  It is important
  114.      for the programmer to explicitly disable modes that are shared, but not
  115.      desired, when in draw modes other than NNNNOOOORRRRMMMMAAAALLLL.  Otherwise the code may
  116.      function differently on different platforms.
  117.  
  118.      Iris Entry graphics do not support OOOOVVVVRRRRDDDDRRRRWWWW or UUUUNNNNDDDDRRRRDDDDRRRR draw modes.  Use
  119.      ggggeeeettttggggddddeeee to determine the number of bitplanes available for OOOOVVVVRRRRDDDDRRRRWWWW or
  120.      UUUUNNNNDDDDRRRRDDDDRRRR on any machine.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.